home *** CD-ROM | disk | FTP | other *** search
/ FishMarket 1.0 / FishMarket v1.0.iso / fishies / 351-375 / disk_370 / sksh / install.doc < prev    next >
Text File  |  1992-05-06  |  7KB  |  265 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.                                 Installation Guide to
  17.  
  18.                                         SKsh
  19.  
  20.                            A ksh-like Shell for the Amiga
  21.  
  22.                                      Version 1.5
  23.  
  24.  
  25.                                (Copyright) 1989, 1990
  26.  
  27.                                      Steve Koren
  28.  
  29.                                     July 21, 1990
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.           Installing SKsh
  74.  
  75.             This  section  descibes how to install SKsh.  It is vitally im-
  76.             portant that all the steps be  performed.   If  they  are  not,
  77.             SKsh  will  not  operate correctly.  In addition, SKsh requires
  78.             version 1.3 of AmigaDos to operate correctly.
  79.  
  80.             Please  examine this file for each release, as it may change at
  81.             any time.
  82.  
  83.  
  84.                1)   First, copy the .skshinit  and  .skshrc  files  to  the
  85.                     's:' directory.  SKsh needs these two  files  to  start
  86.                     correctly.   Their  location can be changed by changing
  87.                     the SKSH: device (see below).
  88.  
  89.  
  90.                2)   Edit your startup-sequence and insert:
  91.  
  92.                          assign SKSH: s:
  93.  
  94.                     This  controls the location in which SKsh looks for the
  95.                     startup files.
  96.  
  97.  
  98.                3)   Copy  the  sksh  binary  itself to  a  location in your
  99.                     AmigaDos search path.  You can be fairly sure the  'c:'
  100.                     directory is in your search path.  If  you  have  modi-
  101.                     fied your path, there may be other  potential locations
  102.                     as well.
  103.  
  104.  
  105.                4)   Set the pure bit on the SKsh binary:
  106.  
  107.                          protect c:sksh rep
  108.  
  109.  
  110.                5)   Make sure that 't:' points to  a  fast  device suitable
  111.                     for  storing temporary files.  A sub-directory on a ram
  112.                     disk is best.  For example,
  113.  
  114.                          makedir ram:tmp
  115.                          assign t: ram:tmp
  116.  
  117.                     You  will  probably want  to  insert some commands like
  118.                     these into your startup-sequence, if they are  not  al-
  119.                     ready there.  SKsh  uses  temporary files only when ab-
  120.                     solutely  necessary, but some types  of  SKsh  commands
  121.                     will  not  function  properly without them (see command
  122.                     subtitution, for example).
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.           SKsh Amiga Shell             Page 2           Installation Guide
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.                6)   SKsh needs a stack size of at least 10000 bytes in  or-
  140.                     der to run properly.   You  can  manually set the stack
  141.                     size to  10000  bytes  using the AmigaDos stack command
  142.                     before you run SKsh, or  you  can  insert 'stack 10000'
  143.                     into  your  startup  sequence (recommended).  If you do
  144.                     not have sufficient stack space, SKsh *will* crash.
  145.  
  146.  
  147.                7)   The  following files need  to  be  copied to a location
  148.                     which is in your SKsh search path  (although not neces-
  149.                     sarily in your AmigaDos search path):
  150.  
  151.                          cat       cmp       cp        crc       cut
  152.                          du        encr      fgrep     grep      head
  153.                          indent    join      num       srun      strings
  154.                          tail      tee       view      wc        window
  155.                          xd
  156.  
  157.                     You can  create a directory called "sys:bin" which con-
  158.                     tains these commands.  The  supplied .skshrc file auto-
  159.                     matically adds this directory to the search path. 
  160.  
  161.  
  162.                8)   This  step  is  optional, but recommended.  The default
  163.                     name for the ram disk is "RAM DISK:".  The  space  will
  164.                     make some  things  difficult to do (but not impossible)
  165.                     in SKsh.  I  recommend that you change the default name
  166.                     of the ram disk in your startup-sequence  to  something
  167.                     like the following:
  168.  
  169.                          relabel ram: RAM_DISK
  170.  
  171.                     The  only  difference is that the space  has  been  re-
  172.                     placed  by  an  underscore, and it will make your  life
  173.                     much easier.
  174.  
  175.  
  176.                9)   Insure  that  your  AmigaDos  ENV:  device  is  set  up
  177.                     properly.  If you are not sure how to do this, see  the
  178.                     AmigaDos manual.
  179.  
  180.  
  181.                10)  You must have  arp.library  installed in your system in
  182.                     the LIBS: directory.  If you are not  sure  how  to  do
  183.                     this, see the arp documentation.  arp  is  available on
  184.                     most Amiga BBS systems.  It is best  to  use  the  most
  185.                     recent  available arp.library, since SKsh will not  run
  186.                     correctly with some early versions.
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.           SKsh Amiga Shell             Page 3           Installation Guide
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.                11)  The pure bit should be set on all of the SKsh  external
  206.                     commands.   This  can  be  accomplished with either the
  207.                     SKsh  chmod  command or the  AmigaDos  protect command.
  208.                     This  is  necessary if the  external commands are to be
  209.                     made resident.  If all  the  external commands are in a
  210.                     single  directory, and this directory contains no other
  211.                     files, then the SKsh command:
  212.  
  213.                          chmod +p *
  214.  
  215.                     will set the  pure  bit  provided that you are cd'ed to
  216.                     the proper directory.
  217.  
  218.                12)  If the script bit is  not  set  on  the  Check_?.?.sksh
  219.                     file (which ?.? is the version number  of  this  SKsh),
  220.                     set it with "chmod +s Check_?.?.sksh".   Then,  execute
  221.                     this script by cd'ing to the  directory  containing  it
  222.                     and typing the  name.   It  will  prompt  you  for  the
  223.                     locations of your SKsh  files,  and  verify  that  they
  224.                     have been installed correctly.  If not, it  will  print
  225.                     and error message for each offending file.
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.           SKsh Amiga Shell             Page 4           Installation Guide
  262.  
  263.  
  264.  
  265.